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INTRODUCTION 

The intent of this document is to provide additional information to system 
software support personnel on how to analize B 800 system dumps. It is assumed 
that the reader is already familiar with the B 800/CMS virtual machine 
structure. This manual should not be expected to provide all the information 
required for a complete analysis of a memory dump. However, the information 
should enable the support person to: 

1. Investigate hardware/software status from clear/starts caused by hardware 
malfunctions, user program logic errors, or HCP failures. 

2. Gain additional insight into th» ctat-nc r\f *h» cyttM at- tha tims «* fk. 

fai lure. 

3. Suggest methods for correcting or detour ing the problem. 

k. Better document the field trouble reports (FTR) when reporting clear/starts 
or other system faults. 

In some cases, the information obtained from the dump analysis may not provide 
enough data to exactly define the failure or the cause. However, in reviewing 
documentation from several failures, similarities may appear which may lead to 
the cause of the failure. 

A list of some of the terms and acronyms used in this document is contained in 
Appendix A. The information is based on the 3.OI.50 I 800 CMS MCP release. 



SECTION 1 
MCP CLEAR/START TROUBLESHOOTING 

The objective of this trouble shooting is to analyze certain areas in a system 
dump, enabling the documenting of an FTR, and to attempt to gather as much 
knowledge as possible about the status of the system at the time of the MCP 
f ai lure. 

The followina is a auide to information that should be documented on an FTR. 

Analyses of" the following areas should be kept on each reported failure and 

reviewed with other reports in a search for patterns and similarities. The steps 
are; 

1. Obtain a copy of the SPO log from the last warmstart banner. Review the 
log for possible error messages from the MCP. Make note of the patch level 
from the warmstart banner. 

2. Verify from the MAT that the task entries do exist. The MCP may just be 
starting or terminating a task. (Refer to Mix Table Worksheet.) 

3. Identify the contents of BMAR, MPCR, and ERROR. These values can be 
obtained from OS register locations §0083§, §008U§, and §00856 
respectively. 

k. Identify the current slice (OS register §000 C§) . 

5. Determine whether the memory links are correct and identify the micro 
slices in the micro extent area. (Refer to Slice Memory Mapping section.) 

6. Identify the current task TID (OS register gOOOAg) and its status. 

7. If the current task is a user program, provide a brief functional 
description of the program. Analyze the current task for the last MCP 
communicate. (Refer to Current Task section.) 

8. Identify the hardware configuration. 

9. Identify any devices with queued l/0s and their status. (Refer to 
Peripheral 1/0 Descriptor section.) 

10. Examine the MCP trail for the history of MAD and interrupts. This trail 
helps identify the last path taken by the MCP up to the failure. (Refer to 
MCP trai 1 section.) 

In some cases, the preceding information, by itself, does not provide enough 
data to exactly define the cause of the problem. Only through the review of 
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documentation from several failures do similarities start to develop. 
Investigation into these similarities produces new ideas and theories which, 
when investigated, may result in clearly defining a set of operations 
reproducing the failure or finding of a possible detour around the failure. 
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SECTION 2 
MIX TABLE ANALYSIS 

The objective is to extract the mix table information from a Hex dump. 

Every attempt should be made to accompany each system dump with the SPO listing 
from the !3St warmstart banner to the system failure. In cases where the SPO 
listing should be verified against the system dump, or if the SPO listing is not 
available, the mix entries can be extracted from the Hex system dump by using 
the mix attribute table (MAT) and the task detail table (TOT). 

The MAT is a task management table located in the operating system table region. 
It is the mechanism by which the operating system controls task switching and 
priorities of tasks. Each entry is one D-word long and a maximum of 16 entries 
are divided into priority classes A, B, and C. In between each class is a wall, 
8FFFF6. 

The task detail table is the logical extension of the mix and, as such, contains 

a great amount of task-related data. The TOT is an overlayable data segment 

owned by the SCL task. It is comprised of one entry per task and is indexed by 

the task number. 

Summarize the mix contents as follows b w lccatin n the infcrm 9l '' nn ■ ■* *^*» mat sn«< 
TDT as subsequently described. 

Independent Runners: 

Task No. Priority Task ID Status 

F - C - Data comm 



E - 


C 


— 


Working set bai 1 iff 


D - 


C 


- 


Help/CTM 


C - 


C 


- 


SCL Loader 


B - 


C 


- 


Data comm space handler- 


A - 


C 


- 


Log 


9 - 


B 


- 


SYS-SUPERUTL 



Use the following table to identify the status for each of the independent 
runners previously listed. 
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User programs: 

Task No. Priority Task ID Status 
8 - - - 

7 " " - 

6 - - - 

5 " - - ' 

k - - - 

3 - - - 

2 - - - 

1 - - - 

- - - 



Identify the priority, task name, and status for each task number. 

MAT - MIX ATTRIBUTE TABLE ANALYSIS 

Complete the following: 

The operating system register. at location @000E© ■ • 



The contents of this register identify the first D-word in the mix attribute 
table (MAT) and should be equal to gFFFFg. The format of the MAT is: wall 
(FFFF) , C tasks, wall (FFFF), B tasks, wall (FFFF) , A tasks, wall (FFFF) . if no 
B or A tasks are in the mix, the walls are next to one another. Each entry is 
one D-word long. The objective is to extract the priority and wait key status 
for each task. 

C FFFF 



B FFFF 



A FFFF FFFF 

Each entry in the MAT can be defined as abed where: 

a - task state cd ■ wait key status 

- - runnable - 00 - running 

■ *4 - short wait « 03 - virtual memory lock 
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8 - 


suspended 


swappable < 


cd - 


ou 


- 


SCL loader lock 


C - 


suspended 


swapped 


m 


05 


- 


open/close lock 








m 


06 


- 


ft.H. accept, di splay 


task ID - mix 


number- 1 


■ 


07 


- 


EOJ lock 


9 ~ 


super uti 1 


ity 


« 


09 


- 


I/O wait 


A - 


log 




m 


OA 


- 


logging initiated by WMST 


B - 


DC space 




■ 


OB 


- 


logging initiated recall 


C - 


SCL loader 




m 


10 


- 


operator stopped 


D - 


help task 




s 


1 1 


- 


suspended by pause 


E - 


W.S. baili 


ff 


■ 


12 


- 


no user disk 


F - 


DC Q hand) 


er 


m 


13 


- 


no file 








as 


H 


- 


dupl icate f i le 








■ 


21 


- 


task waiting restore 








- 


22 


- 


rstinp 








- 


23 


- 


swpint 








■ 


ko 


- 


help task not in use 








BS 


111 


- 


help task waiting CTM 








» 


lf2 


- 


task being loaded 








- 


M 


- 


DC result Q suspended 








K 


M 


- 


DC space handler is idle 








m 


^5 


- 


task wait on accept 








m 


i.6 


- 


task wait zip with pause 








■ 


*7 


- 


task wait event timer 








m 


UB 


- 


access mode restriction 








- 


*9 


- 


waiting device 








- 


i»A 


- 


directory ful 1 








- 


<iB 


- 


task wait for ds/dp 








- 


kc 


- 


waiting SYSMEM file 








■ 


ko 


- 


task wait for device assignment 








K 


kt 


- 


DC wait key 








= 


i ^ 


- 


wait nCS allow/disallow 








■ 


60 


- 


wait on DC buffer space 








« 


61 


- 


wait on subnet Q limit 








■ 


62 


- 


wai t station Q 1 imi t 








BE 


63 


- 


wait MCS EOJ 








= 


6it 


- 


wait MCS Q 1 imit 








= 


65 


- 


wait DC reload 








= 


6D 


- 


wait on sysconfig access 








c 


6E 


- 


wait trace buffer 








& 


6F 


- 


VM wait on I/O 



TDT - TASK DETAIL TABLE ANALYSIS 

The task detail table is found by locating data segment 1 of the SCL-loader 
task. The objective is to extract the task ID for each task. 

1. The base memory address of the slice descriptor table (SDT) is the value 
contained in OS register location §0017§ » . 
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2. The preceding memory location identifies the base of the SDT. The 
SCL-loader is the thirteenth entry in this table. To locate the SCL loader 
slice descriptor add 63C6 to the base address of the SDT, giving . 

3. Each SDT entry is five D-words long. Using the address just evaluated, 
extract the SCL loader slice descriptor. 

(SCL slice descriptor) 



1 2 3 *♦ 5 

D-word U identifies the memory location of the SCL loader task control 
block. Proceed to that memory location and extract two D-words. 

(first two words of SCL loader TCB) 



1 2 

D-word 2 of the SCL TCB identifies the memory location of the data segment 
table base for the SCL loader. Since data segment numbers are 
zero-relative and the data segment desired is number 1, add gfO^g to this 
memory address. 

(SCL data segment 1) 



This memory location finds the SCL loader segment descriptor (four D-words 
long) . Extract four D-words. 

(TDT segment descriptor) 



, . U .»**.— -. IUI fci.C itri .» Cyiild ib M *.»»%. I I p UVI I WCI I k I I I E9 LIIC IIICIIII.II J ouui c^a WIICI c 

the task detail table information can be found. The TDT can now be mapped. 
Each entry in this table is 23 D-words long and is indexed by the task 
number . 

D-word 1 ■ task history and is defined as: 

abed where a - - SPO initiated 

■ 8 - regular zip 

« 2 - zip with DS 

- C - zip wi th pause 

c ■ son's task ID 

d = father's task ID 

D-words 5-8 contains the pack ID in ASCII. 

D-words 9 - )k contains the task ID in ASCII. 

Mark off sets of 23 D-words on the Hex dump and extract the task history, 
pack-ID, and task-ID. Only if a user task is present in the mix is there a TDT 
entry. The number of user tasks should have been determined by the MAT 
analysi s. 



24 



5 (ascii) 8 



(ASCI I ) 



]k 
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SECTION 3 
CURRENT TASK ANALYSIS 



This section utilizes the current task worksheet located 
manual . 



at the end of this 



Part 1 concerns current task information 
running? What was it doing?) 



in low memory. (What program was 



This part can be completed with a minimum of effort. The resulting information 
may be adequate in many cases as a preliminary analysis, it may, for example, 
establish a pattern of repeated failures while executing a certain program or at 
a certain point in a program. This could be helpful for reporting, reproducing, 
or detouring a system failure. 



Current 
task-ID _ 
(word @000A§) 



Mix no. 



(task-ID + 1) 
Program name 



Write down the contents of memory 
location §000A@ from a Hex dump. 
Task- ID values of 0-8 correspond to 
mix numbers of l-<). Task-IDs greater 
than 8 are not assigned to a user 
task. Thus, if current task-ID is 
greater than 8, the remainder of this 
worksheet does not apply. 

i iic orO i og listing accompanying tne 
dump gives the disk codefile name 
for this task. If the SPO log is not 
available, the codefile name can be 
found in the task detail table in the 
dump (see Mix Table Worksheet) . 

te down the contents of memory 

ion §000B§. This gives the starting 

ss in memory of the task control 

(TCB) for the currently executing 
am. 

ing a particular execution of a 
am, the MCP and interpreters build 

and use it for the 
ge and exchange of information about 
ask's progress. The TCB is examined 
rt 2 of this worksheet. 

Several important virtual registers used by the interpreter during program 
execution are located in low memory for convenient access by the interpreter. 
There are several S-registers used by the interpreters, but we are particularly 
interested in these: 



Current 


Wri 


task TCB 


locat 


(word @000B@) 


addre 


also referred 


block 


to as TBC base 


progr 




Dur 




progr 




a TCB 




stora 




the t 




in pa 
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Code 

segment 
number (PSN) 

(word eoo^e) 

Code 

displacement 
in bytes (PCA) 
(word 600936) 

Code 

segment 
address 
(word 8009A8) 

Code 

segment 
size (bytes) 
(word @009B@) 



Current _ 

S-op 

(word eOOADg) 

Line-count _ 
or BIL-flags 
(word 600B66) 

Line-count _ 
(decimal) 



Words 69^6 and 6936 (PSN and PCA) 
contain program segment number and 
program current address, which together 
constitute the next instruction 
pointer . 



Words 69A6 and 69B6 contain the 
absolute memory address and size 
in bytes of the current program 
code segment. 



__ Word 6AD6 contains the actual 
S-opcode being executed by the 
S- interpreter. 

Word 6B66 contains BIL flags for 

an MPLM program, or line-count 

for a C0B0L/RPG program. To use 

the latter, convert 
from Hex to a decimal number. 

!f non-zero this identifies- in 

the compile listing, the line of 

source code being 

executed. (in order for this 

1 in&.fnnnt tn hp mpaninoful . or 

non-zero, the program 
must have been compiled with 
$line-code if COBOL, or with a 
1 in column 16 of H-spec if RPG) . 

Part 2 concerns current task information- from TCB. 

If further information about the current task is required, one or more of the 
component parts of its task control block must be examined. The communicate 
parameter, data segment table, and control stack can each be examined 
independently. 

The first step is to select the part of the TCB to be considered. Go to the 
beginning of the current task control block in the dump. Its address (TCB base) 
was found in part 1. Extract seven D-words from the dump. 
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1 2 
PSN/ISN DST 
base 


3 
DST 
limit 


1* 


5 


6 7 
MCH-TOS MCH 
recover active 
verb 



(TCB) 



PSN/ISN (D-word 1) - program and interpreter identification. 

The low-order (rightmost) byte of this word is either ©106 (for an MPLII 
program) or gllg (for a C0B0L/RPG program). The high order (leftmost) byte of 
this word tells, via the slice descriptor table (SDT) , where the task's program 
control block (PCB) is located. 

The communicate parameter area (CPA) concerns the task's most recent request for 
HCP assistance. 

A "communicate" is a request from a task for the HCP to perform a function 
(usually a logical I/O operation such as file open/close or a read from a disk 
file). Often, when a sysdump is taken, the S-i nterpreter is executing a 
communicate for the current task. For a COBOL program, the current S-op code is 
§2F@. The S-i nterpreter executes this op code by placing the request 
(communicate verb and object), in the communicate parameter area (CPA) within 
the TCB, then calling on the MCPs master communicate handler (MCH) routine to 
perform the requested function. 

To find the CPA, add MCH active verb (D-word 7) 

to the TCB base (found at §000Bfi) 

giving the CPA address 

The contents of the D-word at this address is 



The high order (leftmost) byte of this word is the communicate verb (see 
communicate verb table 3-1 which follows for values). The low order (rightmost) 
byte of this word is the communicate object, usually the data segment of a file 
information block (FIB). For example, a value of §8203@ means mean that the MCP 
was requested to read (verb 82) the file thats FIB is data segment 3« 

Table 3-1. Communicate Verbs 

Class Verb Bits Communicate (byte = verb, byte 1 ■ object) 



B 


00-0F 


B 


01 


B 


02 


C 


10-2F 


C 


ii 


C 


ii 


C 


ii 



file assignment (object ■ FIB segment number) 
file open 
file close 

field oriented 1-0 (object - segment number) 

01 zip 

02 display 
0k pause 
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Table 3-1. Communicate Verbs (Cont.) 

Class Verb Bits Communicate (byte - verb, byte 1 - object) 

C " 08 conditional 
C 20 accept 

D 30-3F data communications 

date-time 
terminate 
wai t 
system status 

machine dependent (B800) 
configurator slice 

file type 1-0 (object - FIB segment number) 
01 conditional communicate 
test status ♦ 
read (not console) 
write (not console) 
rewrite 
delete 

stream control 
start 
overwr i te 
read-wr i te 
read (console) 
write (console) 
get 
put 
redefine workarea 



CONTROL STACK 

The control stack is concerned with the unused returns from subroutine calls. 

The control stack is used by both the interpreter and MCP during the execution 
of the task. The interpreter stores return addresses for subroutine jumps on its 
part of the stack. To some extent, the history of a program's execution can be 
determined from its subroutine "nesting" at a given point in time, especially if 
the program was written in a wel 1 -structured fashion. 

For C0B0L/RPG tasks, the first portion of the control stack (the interpreter's 
part) is also called the "perform stack." It consists of entries four D-words 
long with the following format: 



E 


1*0 


E 


1«1 


E 


1*2 


E 


*»3 


F 


70-7F 


F 


71 


A 


80-9F 


A 


•1 


A 


80 


A 


82 


A 


81* 


A 


86 


A 


88 


A 


8A 


A 


8c 


A 


8E 


A 


90 


A 


92 


A 


9*» 


A 


96 


A 


98 


A 


9A 



1 2 3 *♦ 
line- byte segment 
count offset number 



34 



The line-count field (D-word 1) is a Hex number. Its decimal equivalent relates 
the return address to the source program compile listing. The return address, 
stored in the stack as segment number and byte offset, is used by the 
interpreter to find the next S-op code upon exiting from a subroutine. The K 
value in a stack entry is used by the interpreter to distinguish between exits 
from overlapping subroutines. 

To extract the COBOL/RPG perform stack from a Hex dump: 

add MCH-TOS recover (D-word 6 of TCB) 

to the TCB base (found in part 1 at §000B§) 

g i v i ng 

subtract ©01® giving 



Go to the resulting address in the dump and mark off one record. It represents 
the boundary between the interpreter's part of the stack and the MCP's part. 

Next, go to the address given in D-word 3 of the TCB (DST limit). The control 
stack begins here, immediately following the data segment table. Extract 
repeated four D-word entries from the dump up to the boundary marked previously 
(there may be one word left over) . 

Line- Byte Segment K 
count offset number 
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NOTE 

There may be more than 10 perform stack entries 
but this occurs infrequently. 

When analy2ing the perform stack, remember that the oldest entry is at the 
beginning of the stack, which was written down first, while the most recent 
stack entry is at the bottom of the list of entries just recorded. Also, 
remember to convert the line-count values to decimal before applying them to a 
compi 1e 1 i sting. 
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SECTION 4 
SLICE MEMORY MAPPING 

The objective is to determine which micro slices and task control slices are in 
memory and their sizes. This information is to be used in conjunction with the 
Slice Memory Happing Worksheet to be found at the end of this manual. 

r acuuw ^aiciili nits.1 u calciili anu 91 iwc CAicni at cas vi ilieiliui jr uan Dc mappcru uy 

this process. Pseudo extent ranges from the addresses contained in OS registers 
@000F§ to @0010§. Micro extent ranges from the addresses contained in OS 
registers §0010§ to §001 1§. Slice extent ranges from the addresses contained in 
OS registers §001 1§ to §0012§. 

Memory usage can be determined by mapping out each memory link to and from the 
slice descriptor table. Each memory slice begins with a pointer into the SDT. 
The SDT provides the slice number and length of this slice. Adding the beginning 
address of the slice to the slice length produces the starting address of the 
next memory slice. 

To begin mapping memory, the address of the slice descriptor table base must be 

known. This base address can be found in operating system register @0017§. The 

start of micro extent area must also be known and can be found in OS register 

@0010@. By proceeding to the start of micro extent in the Hex dump, the D-word 

\ral no rtn intc t r\ the QHT Ant- 1" u f r\r f h! c c* 1 i s* a r\f mams\»- \j Du a v -»•« ■ ws ' w*** * k I r- **** 4- *- w 

w w i vi w frv (lib** ww t>i»w w fcr i wi i •. ■ j I Wl bll I •» •> I I V w VI IIIMIIWI / • W f W/\«lll I I I I I iy Lll I 9 CIILI J 

in the slice descriptor table, both the slice number and slice length can be 
determined. (All calculations are in Hex.) 

Slice number The slice number can be calculated by 

subtracting the address of the SDT-base from 
the address of this slice's SDT entry. Dividing 
this answer by §056 gives the slice number. 

Address of the The address of the next slice is 
next slice calculated by using information from the 

SDT entry for this slice. Each SDT entry 
is five D-words long. By adding D-word 3 
and D-word k together the memory address 
of the next slice is given. 

Repeating this process identifies the following memory slices: 

For example: 

OS register 600178 - DCFE SDT-base 

OS register §000F§ ■ 2218 start of pseudo slices 

go to address 2218. Contents of D-word 2218 - DEED 
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address into SDT for this slice's SDT entry 

calculate slice number SOT entry - DEED 

subtract SDT base - DCFE 
giving 1 EF 
divide by g05§ giving 63 (slice number) 
slice number 6636 SPO-Console controller 

Go to address DEED (pointer into SDT for this slice) 
extract 5 D-words: B8l0 0b07 03Aii 2219 0001 
D-word 1 2 3 *• 5 

D-word 3 • 03Mi 
added to D-word k - 2219 

giving 25BD (beginning address of the 

next si ice) 

repeat this process but use the beginning address of the next 
slice instead of OS register §000Fg. 
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SECTION 5 
PERIPHERAL - I/O DESCRIPTORS 

The objective is to determine any queued I/O for a specified drive, the I/O task 
number, the op code issued, and. if an error, the DDP status word. This is done 
using the Hex dump. This information is used in conjunction with the worksheet 
contained in the back of this manual. 

This information is obtained by examining the PHT entry for the selected device. 
The interrupt scan control table (ISCT) should be scanned by the port number to 
extract the PHT memory address. Known information for this objective must be: 

device ■ on port number ■ 



Results are: I/O queued? (Y) (N) 

task # - op code - error ■ _ — 

task # - op code = error - 

task # - op code - error - 

♦ >«u Jf x on code «* error ■ 

lysis n __^_^— ""l" — — — ' 

task # - op code = error - 

To begin analyzing an I/O descriptor, the interrupt scan control table (ISCT) 
must be located. The ISCT memory location is contained in OS register gOO^e- 
Fill in: 

The operating system register at location @00l»3@ ■= 

The contents of this register identify the beginning memory address of the ISCT. 
Each entry is 1 D-word long and the 12 entries correspond to ports 1 through 12. 
The ISCT gives the PHT memory address for that port. A non-zero entry identifies 
which ports have been warmstarted. Locate the memory address found in the ISCT 
register §00i«3@ and fill i n the following blanks: 

Port Address Port Address 

1 7 

2 8 

3 9 
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Port Address Port Address 
i, 10 



11 
12 



Extract the PHT memory address from the ISCT corresponding to the port number. 
This address identifies the beginning of this device's entry in peripheral 
handler tables (PHT) 5"1 and 5"2. Each PHT entry varies in length depending 
upon the device. The first D-word can be used to verify the port number and the 
device kind, this is defined as abed where ab equals port number (zero relative) 
and cd equals device kind. 



Th 



en add £018 to the PHT address from above giving 



This result identifies the memory address of the device controller for this 
device. 

Then add §03§ to the PHT address from above, giving • 



This result identifies the maximum queue number and the current queue number. 
The maximum queue number tells how many devices are on this port. The current 
aueue number identifies which of these devices is in use. For example, there can 
be a 100 TPI drive and a 18 MB fixed disk configured on tne sys L em v^A, «KB, 
DFC andDFD). The maximum queue number equals 3 and, if the current queue 
number equals 2, then DFC is the unit to which the I/O has been d.rected. 

Next, add @02@ to the PHT address from above, giving _. 



... .. ■ /« j ;_..__ I- _._, nrv srtrlroee A value Of O0O00P 

This result identifies tne i/u aescnyuui a memory a— . . ■- 

indicates that no l/0s are queued. A non-zero value points to the memory 
address of the descriptor. The I/O descriptor is six D-words long. Proceed to 
this address and extract four D-words as follows: 

_____ (queued I/O descriptor) 



If additional l/0s are queued for this device, D-word 2 points to the next I/O 
descriptor or back into the PHT table for the device. 

D-word 1 is used to identify the task number and op code. It is defined as abed 
where ab equals interlock and cd equals op-code. 



Convert interlock into bits - _ 

7 6 5 14 3 ^ 1 



a 



b 



bit 7 - - peripheral handler finished 

bit 6 - 1 - key not found (DK)/end-of-f i le (HT) 

bit 5 ■ 1 - permanent error 
bit 7 - 1 - in use by peripheral handler 

bit 6 - 1 - task waiting I/O 
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bit 5 - 1 - waiting for W.S.B. 
bit k - 1 ■ task number = mix number - 1 
bit - 1 - I/O needed 

* - I/O no longer needed 

Op code is 1 byte and defined as: 

Disk Tape LP 

00 read read n /a 



Card 



read 



wr i te n/a 
n/s 

n/a 

n/a 



01 write write 

02 indirect read rewind n/a" ii/a 
5-byte key 

J»2 indirect read n/a n/a 

•3-byte key 

82 indirect read n/a n/a 

21 -byte key 

C2 indirect read n/a n /a n/a 

29-byte key 

03 write with raw check write TM n/a n/a 

04 firmware load backspace n/a n/a 

05 zero disk erase n /a n/a 

06 directory search read status n/a n/a 

07 read with no data n/a n /a n/a 
or al locate 

08 n / a search for TM n/a n/a 

then read 

0A n / a search for TM n/a n/a 

0B n / a write TM then n/a n/a 

write data 

The op code for label processing is: 



80 label read 

81 label write 

83 console label write 

If an error occurred, D-word 3 may contain an error code defined as abed: 

where ab = 80 - character count (MT)/E0F (CRD) 

- 81 - parity error (MT,DK)/read error (CRD) 

■ 82 - timeout/seek error 

= 83 - address error 

= 84 - illegal rewind (MT) 

= CO - end-of-file (CRD) /no file 

= 85 - end-of-tape (MT) 

= 86 - write inhibi t 

= C7 - control card other than end (CRD) 

For card (A9114) cd equals hardware status: 

cd = 10 - early feed eel 1 
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cd • 08 - leading edge cell 

■ Ok - trouble 

■ 02 - no feed 
- 01 - ready 

For line printers, D-word four should be converted into bits as follows: 



15 U 13 12 11 10 9 8 7 6 5 4 3 2 10 

bit ■ 1 - execute specified format control after print 
bit 1 ■ 1 - execute specified format control before print 
bit 2*1- execute specified format control only 
bit l» - - vertical tab with ... 

bit 5 ■ - top of form 

bit 5 ■ 1 - channel number in bits 8 - 15 
bit k ■ 1 - line advance with ... 

bit 5 " " advance 1 line. 

bit 5 - 1 - count in bits 8-15 

Note: channel number is 0-11 for channels 1-12 
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Table 5-1. PHT (Peripheral Handler Table) Disk 



DDP No. 



FPB device kind 



absolute address of controller 



buffer descriptor address 



max Q number 



curr Q number 



Q 
header 



interlock (see below)* Q number 
current descriptor link 
final descriptor link 



Q 
header 
1 



Q 

header 

n 



next PHT-entry address 

control ler 
data area 



H i partAru 

information 

block 

drive 





non-file directory address 
length of non-file directory 
file directory address 
length of file directory 
disk file header disk address 
length of disk file header 



directory 

information 

block 

for 

drive 

1 



directory 

information 

block 

dr ive 

n 



NOTE: One line ■ one D-word entry. 
See Q header interlock table 



5-5 



Table 5-2. PHT (Peripheral Handler Table) Non Disk 



DDP No. 



n 



FPB device kind 



absolute adaress of controller 



buffer descriptor address 



max Q number 



curr Q number 



Q 

header 





interlock (see below) 
current descriptor link 
final descriptor link 



_ 1. 



Q number 



Q 
header 

1 



Q 

header 

n 



next PHT-entry address 



control ler 
data area 



note: one line - one D-word entry. 



ock table (th 


is 


description covers an rHiS/ 


bit 15 » 






Q header 


bit \k « 1 






Q not empty 


bit 14-0 






Q empty 


bit 13 - 1 






current status is ready 


bit 13-0 






current status is not ready 


bit 12 - 1 






last status is ready 


bit 12-0 






last status is not ready 


bit 11 - 1 






waiting help task 


bit 10 - 1 






CTM required 


bit 9-1 






timeout in progress 


bit 8-1 






timeout first part 


bii 7-1 






EOF 


bit 6-1 






device assigned by CTM 


bits 5. J*. 


3 


are undefined 


bits 2, 1, 





are Q number 
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SECTION 6 
ANALYSIS OF MCP TRAIL 

The objective is to examine the MCP trail up to the time of the clear/start. 
Irai? CP i« ra ^^°? SiStS V I 2 - entriCS With each entr * bel "9 two D -*°rds long. %he 

M4C40 ill » § P ' !° ^ C be ? ,nn,n 9 of the trail. The content of register 
fn^lm^madr P °' nter ' " t0 '" ^ tr « M l * ,eh "" ide " tif ' whe " thS next 



Add 

to 

giving 



OS register §001i»@ 
OS register 604548 
the next available entry. 



Subtracting §02§ from this answer identifies the last entry into the trail. 
The format of the trail is as follows: 



Cai ier 
ID 



Current 
TID 



B 
register 



D-word 1 2 

Current TID - current task # = current mix # - I 

Caller IDs * 01, 02, 03, Ok or 05 

B register is dependent upon caller ID. 

Caller ID * 01 - branch-find B register - MAD 

Micro program address descriptor (MAD) entries can be of two types: 

1. Absolute memory address. 

2. Offset and slice number. 

The distinction between the two types of MADs is made by convertina th* R 

"^henU ^V^ nUmbeMn9 " ^ l ° ,eft ' "artingwi h 0) P'bi tt 5 f 
1. then MAD - absolute memory address - 0, then MAD - offset and slice number 
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The absolute memory address is the value represented by bits 1*4-0. 

The offset and slice number can be evaluated by converting the B register into 
bytes. The leftmost byte equals the offset, and the rightmost byte equals the 
slice number. In addition, caller ID equals 02 minus HC timeout; and the B 
register equals PHT entry address. 

By going to the PHT entry address and examining its value, the device port 
number and device kind experiencing the timeout can be identified. For example: 

Caller I D ■ 03 - MC timeout B register - max Q #/current Q # 

The maximum and current queue numbers are part of the PHT entry. The maximum 
queue number tells how many devices are on this port. The current queue number 
identifies which of these devices is in use. For example, a 100 TPI drive and a 
18 MB fixed disk could be configured on the system (DKA, DKB, DFC, and DFD) . 
The maximum queue number is 3 and, if the current queue number equals 2, then 
DFC is the unit experiencing the timeout. (Queue numbering is relative to 
zero.) Next: 

Caller ID - 0k - MC-Q-loop. B register - Q. header address 

If a device should have an 1/0 queued because the unit is Not Ready, when the 
unit is made ready, the queue header address points to the memory address of the 
queued i /u descr i ptor . me ntr nm i ■ c i ■ cv. i> ima <_uauyc vi a t.a uua nun m • » 
entry. Next, 



Caller I D - 05 - PH-IRQ 



B register * device status 



The device status can be examined to determine the actual condition of a device 
from the MCP point of view. Selected devices are defined below. The device 
status should be converted to bits. Number the bits from right to left starting 
with 0. 



Or i nt»r « 



Disk: 



SP0: 



bi 


t 





- 


not ready 


bit 5-7 


- 


not used 






1 


- 


end of page 


8-12 


- 


port # (0 relative) 




2- 


-3 


- 


not used 


13-11* 


- 


not used 






k 




print 
complete 


15 




data request, IOC 
ready to receive 


b! 


it 





- 


search good 


bit b 


- 


parity error 






l 


- 


write inhibit 


7 


- 


timeout 






2 


- 


seek error 


8-12 


- 


port number (0 relative) 






3 


- 


illegal address 


13 


- 


read after write check 






k 


- 


file not open 


U 


- 


index mark 






5 


- 


seek incomplete 


15 


— 


sec -or mark 


b 


it 





- 


not ready 


bit 5-7 


- 


not used 






l 


- 


input request 


8-12 


- 


port number (0 relative) 






2 


- 


end-of-message 


13-H 


- 


not used 






3 


- 


error 


15 


- 


data request 






k 


- 


service too late 
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Console 



as data 

bit 

1 

2 

3 

i. 

5 



entry: 

- carrier stall 

- over speed 

- interrupt not 
honored 

- ready 

- keyboard ready 

- printer ready 



DEK as entry station: 

bit - buffer full 

1 - parity error 

2 - not used 

3 - framing error 

k - service too late 

Tape DMAC (PE): 

bit — not ready 

1 - busy or RWD 

2 — file protect 

3 - EOT 

4 - BOT 

5 — blank tape timer 



Disk Pack: 



bit — link parity error 

1 — time out error 

2 — read after write error 

3 — search greater/equal 

4 — search good 



bit 6 - forms ready 

7 - carrier buffer ready 
8-12 - port number relative) 
13 " not used 
]k - end-of -paper 
15 - data request, ready 
to receive data 



bit 5 - not used 

6-7 - station address 
8-12 - port # (0 relative) 
13~1*» - not used 

15 - exception bit 

bit 6 — tape mark 
7 -CER 
8-12 - port (0 relative) 

13 - 1600/800 BPI 

14 — tape error 

15 — op successful 



bit 5 — local 

6 - 7 - MTR use 

8-12 - port (0 relative) 

13-15 - MTR use 



Note 

Link parity is a parity error on a data transfer from the B 9387 to the B 800. 

Time out is a no response from the B 9387 to a command by the B 800. 

The entries in the MCP trail for disk pack do not reflect drive related errors,such as 
a seek error. They only reflect errors in communication between the B 9387 and the 
B 800, results of search operations, results of read after write operations, and of the 
B 9387 going to a local state. These are all DDP oriented errors. If a disk pack drive 
is the suspected problem area, the system log and any related SPO messages must 
be used to determine any drive error related information. 
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SECTION 7 
SLICE DESCRIPTOR TABLE OVERVIEW 



The slice descriptor table (SDT) is an MCP table located in the upper portion of 
memory. It keeps track of the location of the following structures for the MCP? 

1. The task control blocks (TCB) for each mix number, 

2. The micro slices of the MCP. 

3. The program control blocks (PCB) for each user task. 

The slice descriptor table is created at warmstart/restart time from information 
passed from warmstart to the OS-build module of the MCP. The SDT is created 
using either the warmstart configuration entered by the operator or a restart 
configuration entry located on the current system disk if the system is brought 
up by the restart or clear/start. 



The SDT has an entry for each possible user task (nine entries for nine user 
tasks); seven entries for the MCP independent runners, a variable number of 
entries for all the MCP slices used in the system while running, and nine 
entries for each possible user program control block. There is a pointer to the 
absolute D-word location of the SDT base located in the operating system 
registers at location g0017§. There is a second pointer to the base of the 
program control block section of the SDT located in the OS registers at location 
800196. 

The purpose of the slice descriptor table is to point to the current absolute 
position of the TCBs, MCP slices, and PCBs either in memory or disk. The memory 
management flags located in the first byte of each 10-byte entry (five D-words) 
in the SDT indicate that the slice, TCB, or PCB is either in memory or on disk. 
The various MCP virtual memory management routines use this table to maintain 
the current location of these structures. 



The following illustrates the pointers to, location of, and internal information 
concerning the slice descriptor table (SDT). 
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Base of memory 


0000 










«««««« 


<«««« 


0017 






V 
V 




0019 


>»»»»»»» 


»»» 


V 






V 


V 




first 256 D-words 


V 


V 




OS registers 


V 


V 




V 


V 






V 


V 




micro slice area 


V 


V 






V 


V 




V 


V 






V 


V 




TCB and PCB slice area 


V 


V 
V 
V 






V 






V 
V 


V 




overlayable area 


V 


V 


. 




V 


V 




V 


V 






V 


V 




data comm space area 


V 


V 






V 


V 




V 


V 




OS tables: 


V 


base of 


SDT 


task control block 


V 






entries 


V 
V 






NCP si ice entries 


V 
V 


base of 


PCB 


program control block 


««« 




xxxx 


entries 




Top of memory 
memory addr 


remaining OS tables 















Format of a slice descriptor table entry. 



Byte 



D-word 
length 



flags 



1 



disk 
flag 



disk 
address 



1 



L± 



length 



memory 
base 



10 bytes / 5 D-words 
MM flags byte 



8 



pointers/ 
counters 



Disk flag 



Most significant ' 
bit of most 
significant digit 
of byte 1 



Flags which determine type 
of slice and location (disk 
or memory) . 

Flag which, when set, 
indicates slice is on 
a disk pack (system 
disk is a pack) . 
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Length 
Memory base 



Poi nters/ 
counters 



bytes k and 5 
bytes 6 and 7 



bytes 8 and 9 



Slice length in D-words. 

The absolute D-word memory 
address of the base of the 
si ice; i f MM flags 
indicate that the slice is 
in memory. 

The base is a TCB or a 
device controller slice 
if TCB - most significant byte 
is slice number of program 
parameter block. Least 
significant byte is slice 
number of interpreter slice. 
If slice is not a TCB, both 
bytes combine to give 
a user count for the 
slice, if it Is a device 
control ler. 



MEMORY MANAGEMENT FLAGS FOR SDT 



The only structures described in the slice descriptor table are: 

1 . Micro si ices. 

2. Controller micro slices. 

3. Ask control blocks. 

*». Program control blocks. 

The value of the memory management flags for these structures depends on whether 
the slice is in main memory, page memory, or absent from memory: 



location 

in... 
memory 

page 

absent 



Micro si ice 


Control ler 


TCB 


PCB 


§A8@ 


@B8@ 


@C2§ 


§E2@ 


@AC@ 


@BC§ 


§C6@ 


§E6@ 


@28@ 


§38§ 


§1»2@ 


§62@ 
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The detailed structure of the slice descriptor table (SDT) is: 

1. The first nine entries are locations for up to nine task control blocks for 
user tasks. If an entry is not in use, it should consist of all zeros. If 
in use. a valid entry is located in the same relative position as the task 
mix number. (For example, position 1 equals mix number 1, position 9 
equals mix number 9). 

2. Seven entries are for the MCP independent runner tasks in mix number order. 
That is: 

mix 10 * super utility (SU) 



mix 11 - system logging (LOG) 



mix 12 » data comm space handler 



mix 13 - SCL loader 



mix \h ■ help task 



mix 15 ■ working set bailiff 



m 



ix 16 ■ data comm queue handler task 



The total complement of basic slices used by the system is given. Some are 
permanently stored in the operating system nucleus; for example, the 
controllers for disk and SPO. The rest are brought into micro memory slice 
area as they are needed or, if they are controllers, when the device is 
opened ior input/ output, in any case, si ■ possiuie Si ices, Known or 



warmstarted, have positions assigned 
descriptor table. 



in the remaining area of the slice 



The last 10 positions of the slice descriptor table are the program control 
blocks for super utility and up to nine user tasks. There is a separate 
pointer to the base of these 10 positions located in the operating system 
registers at @0019§. The first PCB entry in this area is for the system 
super utility, followed by the nine entries for the user PCBs. An all -zeros 
entry indicates the PCB is not in use. 



74 



SECTION 8 
MCP SLICES 



Table 8-1 is a list of the slice descriptor 
change due to recompi lation or patches. 



table entries. The length may 



Table 8-1. Table of MCP Slices 



SI 


ice 








Length 


Numbers 


nam 


e 




(D Words) 


Hex ! 


Dec 








Hex Dec 








TCB si ice mix 


# 


1 


var i es 


1 


1 


TCB si ice mix 


# 


2 


varies 


2 


2 


TCB si ice mix 


# 


3 


varies 


3 


3 


TCB si ice mix 


# 


k 


varies 


k 


k 


TCB si ice mix 


# 


5 


var ies 


5 


5 


TCB si ice mix 


# 


6 


varies 


6 


6 


TCB si ice mix 


# 


7 


varies 


7 


7 


TCB si ice mix 


# 


8 


var ies 


8 


8 


TCB si ice mix 


# 


9 


var ies 


9 


9 


Super uti 1 i ty 


TCB 


var ies 


A 


10 


Logger TCB 






var ies 


B 


ll 


DC-space-handler TCB 


varies 


C 


12 


SCL/loader TCB 




varies 


D 


13 


Help task TCB 






002E 001*6 


E 


lit 


WSB task TCB 






0023 0035 


F 


15 


DC queue handler TCB 


var ies 


10 


16 


BIL-SI 








11 


17 


COBOL-SI 








12 


18 


COBOL- INT-slii 


ce 




0229 0553 


13 


19 


Bl L-auten 






0237 0553 


}k 


20 


Open-close 






01 AE 0430 


15 


21 


Printer-open 






04 A5 1189 


16 


22 


Printer-close 






01 E4 0484 


17 


23 


Card-open 






025E 0606 


18 


Ik 


Card-close 






0121 0289 


19 


25 


Tape-open- 1 






026B 0619 


1A 


26 


Tape-close-1 






0301 0769 


IB 


27 


Disk-open-1 






0213 0531 


1C 


28 


Disk-close-1 






0377 0902 


ID 


29 


Debug-COBOL-SI 




1909 6409 


IE 


30 


Class-D-sl ice 






1C2F 4815 


IF 


31 


Date-time 






02A3 0675 


20 


32 


Accept-sl ice 






02A2 0674 


21 


33 


Al loc-sl ice 






02CE 0718 



Remarks 



BIL/MPLII interpreter 
C0B0L/RPG interpreter 



Ml CR subsystem 
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Table 8-1. Table of MCP Slices (Cont.) 



22 


34 


OS-to-SCL 


0174 0372 


23 


35 


MH-slice 


01 CO 0448 


24 


36 


RTC-sl ice 


0171 0369 -RTC controller 


25 


37 


D/T-comm-sl ice 


0141 0321 date/time request chg 


26 


38 


Dl-sl ice 


0317 0791 MX function 


27 


39 


Zip/display-sl ice 


0298 0664 


28 


40 


EOJ-sl ice 


02SA 0602 


29 


41 


DC-slice 




2A 


42 


Loader-sl ice-#l 


042A 1066 


2B 


43 


Loader-sl ice-#2 


03D1 0977 


2C 


44 


Loader-sl ice-#3 


02D1 0727 


20 


45 


Loader-sl ice-#4 


0322 0802 


2E 


46 


Loader-sl ice-#5 


0123 0291 


2F 


47 


DC-space 


00AA 0170 


30 


48 


DS-sl ice 


01FF 0311 


31 


49 


RTC-date-fix 


009B 0155 


32 


50 


Stop-sl ice 


01A9 0425 


33 


51 


Go-si ice 


0154 0340 


3* 


52 


Power -off 


0206 0518 


35 


53 


OL-slice 


0260 0621 


36 


54 


AD-slice 


036C 1004 


37 


55 


DMAC-disk-slice 


0178 0376 -disk controller 


38 


56 


SPO-sl ice 


01FD 0509 -spo controller 


39 


57 


DC-ch-30 


03D2 0978 


3A 


58 


DC-ch-31 


032C 0812 


3B 


59 


DC-ch-32 


03A9 0937 


3C 


60 


DC-ch-33 


03AA 0938 


3D 


61 


DC-nucleus 


0633 1587 


3E 


62 


DC-task-EOJ-slice 


006B 0107 


3F 


63 


DC- loader 


027F 0639 


4o 


64 


Help-task-sl ice 


03E1 0993 


H 1 


65 


Working-set-bai 1 iff 


02 E4 0740 


42 


66 


Clear-start 


0F92 3986 


43 


67 


Configurator 


0083 0131 


44 


68 


OS-tracer 


017C 0380 


i. f- 


en. 


rk* w A t _ i • _ 


ammA «. - /■ n 


*»? 


03 


ui-tuj-s i i ce 


uoo uj>oo 


46 


70 


Reconstruct 


0165 0357 


^7 


71 


RY-slice 


0121 0289 


48 


72 


XD-sl ice 


0397 0919 


49 


73 


DC-sh-sl ice 


00AA 0170 


4A 


74 


DC-eh-sl ice 


0238 0568 


4B 


75 


DC-LDR2-slice 


01E2 0482 


4C 


76 


DC-LDR3-slice 


•0117 0279 


4D 


77 


DC-LDR4-slice 


'0312 0786 


4E 


78 


AD-disk 


0000 0000 


4F 


79 


Indexed-sl ice 


0B31 2865 


50 


80 


PE-table 


0201 0513 


51 


81 


DC-no-DCOM-slc 


0053 0083 


52 


82 


Disk-open-2 


02DA 0730 


53 


83 


Disk-open-3 


049A 1178 


5^ 


84 


Disk-close-3 


0498 1176 


55 


85 


Tape-open-2 


02A5 0677 
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Table 8-1. Table of MCP Slices (Cont.) 



56 86 Tape-open-3 


0206 


0694 




57 87 Tape-close-2 


02B6 069 1 * 




58 88 Tape-close-3 


013A 031^ 




59 89 EOJ-slice-2 


0200 


0512 




5A 90 EOJ-slice-3 


021 F 


0543 




5B 91 Deal loc-sl ice 


0277 


0631 




5C 92 OS-susp-sl ice 


0295 


0661 




5D 93 Stream-slice 


0251 


0593 




5E 9^4 index-open- 1 


027A 


0634 




5F 95 Index -open- 2 


0237 


0567 




60 96 lndex-open-3 


027B 


0635 




61 97 1 ndex-open-l» 


02 F9 


0761 




62 98 lndex-close-1 


0323 


0803 




63 99 SPO-console 


03C6 


0966 




61» TOO Interp-subs 


000F 


0015 




65 101 Console-slice 


075D 


1885 


console control ler 


66 102 lndex-open-5 


024A 


0586 




67 103 Sort-slice-1 


0416 


1046 




68 ]0h Sort-slice-2 


0587 


1415 




69 105 Sort-slice-3 


0000 


0000 




6A 106 DC-ch-3 1 * 


023D 


1 i*l 1 




6B 107 DC-ch-redeft 


0368 0872 




6C 108 DDE-SPO 


049A 


1178 


-DDE SPO control ler 


6D 109 DDE-con 


0600 


1536 


-DDE cons controller 


6E 110 Log-task-slice 


OltDA 


12*42 




6F 111 SSC-slice 


02D6 0726 




70 112 Disk-pack-ctlr 


021 B 


0539 


-disk pack control le 


71 113 Large-scrn-SPO 


01DE 


Oi»78 


-TD83O SPO control le 


72 lll« FD-slice 


020C 


0524 




73 115 Int-mul-div 


029D 


0669 




* . , , 1 




ftT l/\ 




71* lib DC-preii-ioaa 


U/ IV 




75 117 R/W-console 


026C 


0620 




76 118 Log-write-slice 


0119 


0281 




77 119 Pack-nuc-end 


00A7 


0167 




78 120 Any warms tar ted 


control lers are 


loaded 


thru in this area of 


the si ice 


descriptor table. 


xx xxx These controllers are any 


device 


: other than 


the disk and the SP0 controllers 




xxx xx PCB entries 








+1 +1 first PCB 


var ies 


SYS-SUPERUTL 


+2 +2 second PCB 


var ies 




+3 +3 third PCB 


varies 




+k +k fourth PCB 


var 


ies 




+5 +5 fifth PCB 


varies 




+6 +6 sixth PCB 


varies 




+7 +7 seventh PCB 


var ies 




+8 +8 eighth PCB 


var i es 




+9 +9 ninth PCB 


var i es 




+10 +10 tenth PCB 


1 var 


- ies 
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SECTION 9 
B800 MEMORY LAYOUT 



The following is a description of the B 800 memory layout: 



.0000. 



SL9 registers 
0100 



HCP nucleus 



1B25. 



DC-nucleus 
-BVM 2158 — 



control lers 
-pseudo extent- 



micro si ices 



-micro extent- 



TCBs £ PCBs 



■si ice extent- 



over lappable memory 
s-code & data segments 



"DC extent" 



.0000. 



page- i nt-subs 
007 A 



page-com-subs 
0l»6A 



page-COBOL- int 
1278 



page-bi 1-int 
—2000 



M 
I 

C 
R 


M 
E 
M 
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DC space 
NDL s-code, tables, buffers 



EVM 

OS tables 
MCP trail, MAT, ISCT 
SDT, PHT, MCP data 



-eom. 



Related notes: 

1. Beginning of virtual memory is 1B25 if data comm is not present and 2156 if 
data comm is present. 

2. DC extent equals end of virtual memory (EVM) if data comm is not present. 

3. The only absolute addresses are SL9 registers, MCP nucleus, DC nucleus, and 
page interpreters. All other addresses vary depending on the program mix 
and the hardware configuration. 

k. Page memory and micro memory are both 8K words. When the MCP is in control 
of the system, page memory constitutes the first 8K words of main memory. 
When an interpreter is in control of the system micro memory 1 constitutes 
the first 8K words of main memory. Micro memory 1 is treated as read only 
memory and is never written to. Switching between the two memories is 
performed by a string of micro code as control is being transferred. 
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SECTION 10 
MCP NUCLEUS 

The MCP nucleus basic routines (by absolute memory address) are given in this 
section. They are: 

010C General routines. 

Read/write memory, common routines used by 
controllers, and common register manipulations. 

01C3 Byte handling routines. 

Manipulation of fixed format tables (such as PPB, 
FPB) . 

02AC Access/manipulate OS structures. 

Binary multiple, divide, and modulo. 
Accepts a slice number and returns an absolute 
memory address. Locates desired OS system buffers 
and manipulates TCB stack. Works with debug trail 
and 1 ink checking. 

04D0 OS EPAR. 

This is the central task switching routine 

of the system. The MAT is scanned for the highest 

priority task which can be run. If none exists, then 
service I/O interrupts and continues to scan. If a 
task is found, then the OS state alters to reflect 
the task and the CPU is switched. 

05E7 Interpreter common subs. 

Used when control is given up by the interpreter 
and back to the MCP. 

05F6 Virtual memory. 

Get/put micro slices. 

Get/put pseudo slices. 

Get/put space. 

Expand/shrink slice. 

Get/put segments. 

DC get/put space. 

Get/put DC nucleus. 

Thrashing detection (08B2 - 08C2) 

Garbage man (08C3 - 08F1) 

Cleans up the available chain from slice extent 

to DC extent after all gets, puts, and 

detected thrashing conditions. 
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OA38 Working set bailiff. 

Resident portion of WSB. 

It cleans micro memory of all micro 

slices except controllers. This feature is used if 

there is insufficient memory space 

available for the IR WSB. After space has been 

made available, the IR WSB is loaded. 

0A6E Master interrupt processor (HIP). 

Ml P interfaces with all device controllers and the 
peripheral handler. Control is transferred 
to the I/O controller if an interrupt needs 
service. 

0AE1 Media controller (MC) . 

MC recognizes media insertion. It also facilitates 
device timeout for recovery from DDP/device 
limitations. The timeout logic in the various 
controllers is device/operation dependent. Controllers 
for devices that do not require timeout servicing 
contain their own timeout logic. MC initiates 
automatic retry of I/O after correction of a 
not ready condition has been encountered. 

0C50 Peripherial handler (PH) . 

PH handles the I/O interface with read/write, open/close, 
virtual memory, and loader. It inserts the buffer 
descriptor into the queue and initiates the I/O if 
possible. It also removes the buffer descriptor from 
the queue and initiates the next descriptor. PH 
optimizes the seeks for disk. By comparing the disk 
addresses in the buffer descriptors queued, new l/Os 
are added to the queue in the correct slot in an 
attempt to keep the disk arm moving in one direction. 
PH halts l/Os if VM demands control to slide 
memory affecting buffers, FIBs, and so on. The I/O is 
resumed once the VM operation is complete. 

ODCA SCL handler. 

This routine expands the SCL-LDR-TCB slice by 268 bytes 
to create an I/O descriptor and buffer for SCL input. 
Once space has been obtained, the I/O is initiated. 
Preceding blanks are removed from the message until 
the first alpha character. SCL now scans through 
the legal SCL op table for a valid verb to obtain the 
op code. It also checks for communication from 
SYS-SUPERUTL and for MICR functions (GR, GK, NR) . 
Based on the SCL entry, control passes to the 
appropriate slice: (Dl-slice, OL-slice, RY-slice). 
After the function is complete, the SCL buffer area is 
removed by VM shrink and control is given back 
to MCH. 
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OF65 Master communicate handler (MCH) . 

It is the function of this routine to interrogate 
the verb of a CPA and cause the correct communicate 
class to be alerted. Minimal syntaxing of the verb 
is performed based on value range. Further decoding 
is done by the class decode. 

1 7D9 Resident logger. 

This routine moves SCL messages to the log message 
queue. It also transfers I/O counts from the logger 
TCB to the log files. 

1A1F Clear/starts 

Performs soft DPM read error, tests for parity errors, 
and writes memory contents to DMFILOO. 

1AC9 Ninty D-words reserved for nucleus patch area. 

1 B2A End of nucleus. 

1B23 Interp-trail 

These two words are used by the interpreters to store info when they leave and return to the 
2 MHZ page. On leaving, they update the first word with the operating system destina- 
tion and zero out the second word. On returning, they write the page destination into the 
second word. If word two is zero at the time of a clear/start, execution was in the MCP. If 
word two is non-zero, execution was in the interpreter. 

1B25 End of nucleus. 
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SECTION 11 
DESCRIPTION OF MICRO SLICES 



The following is a brief description of the slices pointed to in the slice 
descriptor table. Some functions are segmented into multiple slices. For 
example, tape open is performed by tape-open- 1, tape-open-2, and tape-open-3. 
This is done to minimize the amount of micro memory required to perform a 
function, as only one of the slices of a multiple slice function is required to 
be m memory Si any one wsme. 



Hex/Dec 

OA/10 Logger TCB 

This is the task control block for the independent runner 
portion of log task. The data segments are: 

0. Log message queue. 
Size is 572 D-words. 

1. Log file FPB. 

Size is 32 D-words. 

2. Log f i le FIB. 

This FIB is for the log file marked as active. 

3. Log file 2 FIB. 

This FIB is for the log file marked as next active. 

4. Log file work area. 
Size is 90 D-words. 

OB/11 DC-space-handler TCB 

This is the task control block for DC-space-handler slice 
and is also used by the data comm loader. The data segments 
are: 

0. DC-loader FPB for NDLSYS. 
Size is 32 D-words. 

1. DC- loader FIB for NDLSYS. 

2. DC-loader FPB for NDL- interpreter for DCP 0. 
Size is 32 D-words. 

3. DC-loader FIB for NDL- interpreter for DCP 0. 
1». DC-loader FPB for NDL-interpreter for DCP 1. 

Size is 32 D-words. 

5. DC-loader FIB for NDL-interpreter for DCP 1. 

6. DC- loader space handler area. 

7. DC-loader FC area. 

0C/12 SCL-loader TCB 

This is the task control block for the independent runner 
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portion of the SCL- loader. It is also used by many other 
slices of the MCP. The data segments are: 

0. Configuration table. 

1. Task detail table. 

2. SPO output buffer. 

3. Error message table. 

It. Initiating message input buffer. 

5. Loader FPB for code file. 

6. Loader FIB for code file. 

7. Loader FPB for virtual memory file. 

8. Loader FIB for virtual memory file. 

9. Six-B-tab buffer. 

Work buffer used by many slices. 

10. Loader getseg-ppa2 buffer. 

Used by loader for DST, CST, CCB, and TCB working 
storage area. 

1 1 . Message-group- 1 . 
OS message table. 

12. Message-group-2. 
Interpreter message table. 

13. Message-group-3. 

Data com message table. 
ll». SCL work buffer. 

15. Trace buffer. 

16. Al locate-deal locate work buffer. 

17. Open-close work buffer 1. 

18. Open-close work buffer 2. 

19. Indexed open work buffer. 

20. Power off work buffer. 

21. Through 29. Sort work buffers. 

One work buffer for each mix number 1 through 9. 
30. Through kO. Indexed key work area. 

One area for each mix number 1-11 for key building. 
i»l. System status work buffer. 
1*2. Work area for sysconfig file. 
1»3. FIB for sysconfig file. 
kU. FPB for sysconfig file. 

0D/13 Help task TCB 

Task control block for the independent runner help task. 

The data segments are: 

0. HT-card-BD-SD. 

I/O buffer for help task. 

1. HT-label-SD. 

Buffer used for label syntax. 

OE/T* WSB task TCB 

Task control block for the independent runner portion of 
working-set-bailiff. This TCB has no data segments. 

OF/15 DC queue handler TCB 

Task control block for the data comm result queue processor, 
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which is part of the DC-nucleus. This TCB has no data 
segments. 

10/16 BIL-SI 

This slice is the interpreter for BIL and MPLM programs. 
It is loaded at warmstart time to micro memory 1 (logical 
page) and is not overlayable. The slice descriptor shows 
an absolute memory in mm! but no slice length. 

11/17 COBOL-SI 

This slice is the interpreter for COBOL and RPG programs. 
It is loaded at warmstart time to micro memory 1 (logical 
page) and is not overlayable. The slice descriptor shows 
an absolute memory in mml but no slice length. 

12/18 COBOL-INT-sl ice 

Interprets COBOL "compare for class" and RPG "move sign" 
constructs. This slice was part of COBOL-SI prior to 3*1 
release. 

13/19 BIL-auten 

processes MPLM data comm authenticator communicates. 

14/20 Open-close 

This slice is the common entry point to all open and close 
communicates. It checks the communicate for syntax and 
decodes it. 

15/21 Printer-open 

Processes open communicates for line printers, serial 

printers, console, and keyboard files. 

Provides: 

1 . Dev ice all ocat i on . 

2. FIB construction. 

3. Priming of the device. 

16/22 Printer-close 

Processes close communicates for line printers, serial 

printers, console, and keyboard files. 

Provides: 

1. Completion of outstanding physical l/0s and 
label writing. 

2. FIB removal . 

3. Release of hardware device (not done if half 

close) . 

17/23 Card-open 

Processes open communicates for all card devices. 
Provides: 

1. Device allocation. 

2. Construction of the FIB. 

3. Priming of the device. 
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18/21* Card-close 

Processes close communicates for all card devices. 
Provides: 

1. Completion of outstanding physical l/Os and 
label writing. 

2 . Remova I of the FIB. 

3. Release of hardware device (not done if half 

close) . 

19/25 Tape-open- 1 

First phase of tape open communicate processing. 
Provides: 

1. Location of FPB and configuration table. 

2. Decode of FPB parmeters. 

1A/26 Tape-close-1 

First phase of tape close communicate processing. 
Providesi 

1. Completion of outstanding physical l/Os. 

2. Decode of close parmeters. 

3. Label writing. 

k. Handling of change reel. 

IB/27 Disk-open-1 

First phase of disk open communicate processing for all 

types of disk files except indexed. 

Provides: 

1. Syntax of open verb. 

2. Routines for error handling during open. 

1C/28 Disk-close-1 

First disk close communicate processing phase for all 

types of disk files except indexed. 

Provides: 

1. Completion of outstanding physical l/Os. 

2. Decoding of close parameters. 

ID/29 Debug-COBOL-SI 

This slice is used by engineering for development. The 
final release MCP file does not contain any code for this 
si ice. 

IE/30 Class-D-slice 

PSL interpreter. 

IF/31 Date-time 

Processes operator requests to change either the date and time 
that was entered at warmstart or a prior DT message. 

20/32 Accept-slice 

Processes AX messages for SYS-SUPERUTL and application 
programs. 
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21/33 Alloc-slice 

Gains disk space from the available table and updates 
the disk file header. 

22/3*4 OS-to-SCL 

Formats SPO messages for fatal errors to a task (DS or DP 
messages) . 

23/35 MH-slice 

Formats all SPO messages except DS or DP and clear/start. 

24/36 RTC-slice 

Controller for real time clock. 

25/37 D/T-comm-sl ice 

Processes date and time request communicates from 
application programs. 

26/38 D I -si ice 

Processes operator requests for MX. 

27/39 Zip/display-slice 

Processes zip and display request communicates from 
application programs. 

28/1*0 EOJ-slice 

First phase of end-of-job processing. 
Provides: 

1. Interface to DS or DP SCL commands. 

2. Processing of terminate communicates. 

3. Processing of abort program loads. 

29A1 DC-slice 

This slice attempts to get a data comm buffer, move 
data from a SPO buffer into it, and enqueue the message to 
the HCS queue. 

2AA2 Loader-sl ice- 1 

First phase of processing a load program request. 
Provides: 

1. Determination if request is part of load utility 
or SYS-SUPERUTL. 

2. Opening of code file. 

3. Updating of slice descriptor table. 

2BA3 Loader-sl ice-2 

Second phase of processing a program load request. 
Provides: 

1. Gains in disk space for virtual memory file. 

2. Updating of task detail table. 

3. Updating of mix attribute table. 
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2CAU Loader-sl ice-3 

Third phase of processing a program load request. This 
slice builds the task control block. 



20A5 Loader-sl ice-*i 

Fourth phase of processing a program load request. 
Provides: 

1. Determination if a program control block exists. 

2. Building of a program control block if one does not 
exist. 

3. Link task control block to program control block. 



2EA6 Loader-sl I ce-5 

Fifth phase of processing a program load request. 
Provides: 

1. Error recovery for load failures. 

2. Updating of the task detail table in the case of a 
zip. 

3. Determination if a debug interpreter is needed. 



2FA7 DC-space 

This slice is set to the size of the data comm area in 
memory, calculated when a NDLSYS program is loaded. 
It contains the data comm buffers, NDL S-code, and NDL tables. 
There is no micro code in this slice. 

30A8 DS-slice 

Processes DS, DP, and PR SCL commands. 



31A9 RTC-date-fix 

llnrlal-ae rlnto at »nH-nf-Hav (JLCiCl hours) . 

w f*\S M W C ■* MW to»P .ate w ■ « w — • w — f » — ■ • *=- — f - 

32/50 Stop-slice 

Processes requests to stop an executing program. 

33/51 Go-slice 

Processes requests to restart a program that is suspended 
by: 

1 . ST command . 

2. Pause communicate. 

3. No user disk condition. 
k. Special forms request. 

5. No file condition. 

6. Duplicate file condition. 

3V52 Power-off 

Processes requests for an orderly shut down of an entire 
disk. 
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35/53 OL-slice 

Processes requests by: 
1 . OL SCL command. 

2. Configuration table maintenance to print out status 
of a peripheral it has just recognized. 
3- Help task to print out status of a peripheral that 
has gone Not Ready while in use. 

36/51* AD-slice 

Processes assignment of a peripheral to a program by an 
operator in the following cases: 

1. Unlabeled input file. 

2. Special forms. 

3. No file condition. 

k. Duplicate file condition. 
5- Printer unavailable* 
6. No user disk. 

37/55 DMAC-disk-slice 

Disk controller for fixed, cartridge, and super mini units. 

38/56 SPO-slice 

Controller for TU201 SPO. 

39/57 DC-CH-30 

Processes data comm communicates with a verb value of 30. 
This slice is entered from the master communicate 
handler. The adverb values are: 

Communicate Adverb 



queue 


00 


queue. depth 


01 


set. input. limit 


02 


set. queue. limit 


03 


exchange. reference 


Ok 


fetch. message 


05 


get. message. space 


06 


re lease. message. space 


07 


read. header 


08 


wr i te. header 


09 


read. text 


OA 


wr i te.text 


OB 


copy. text 


OC 


continue. stat ion 


OD 


continue. task 


OE 


route. input 


OF 


route. output 


10 


al low. input 


11 


disal low. input 


12 


allow. output 


13 


disal low. output 


lit 


set. output. 1 imi t 


15 
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3A/58 



DC-ch-31 

Processes data comm communicates with a verb value of 31 
This slice is entered from the master communicate 
handler. Their adverb values are: 



Communicate 



Adverb 



1 i ne. count 


00 


station. count 


01 


modem. count 


02 


terminal .count 


03 


subnet. count 


01* 


1 ine. number 


05 


stat ion. number 


06 


queue . nuumber 


07 


1 ine. description 


08 


stat ion.descript ion 


09 


modem. description 


0A 


terminal .description 


0B 


subnet .descr i pt i on 


OC 


1 ine. stations 


0D 


subnet. stat ions 


0E 


1 ine. status 


OF 


station. status 


10 


task. name 


11 


task. number 


12 


recal 1 


13 


clear 


11» 
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DC-CH-32 

Processes data comm communicates with a verb value of 32. 
This slice is entered from the master communicate 
handler. The adverb values are: 



Communicate 

redefine. 1 ine 
redefine. station 



Adverb 

00 
01 
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DCrch-33 

Processes data comm communicates with a verb value of 33 
This slice is entered from the master communicate 
handler. The adverb values are: 



Communicate 

enable. input 

disable. input 

enable. output 

disable. output 

receive 

send 

accept 



Adverb 

00 
01 
02 
03 

0*4 

05 
06 
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3E/62 



3F/63 



1*0/6^. 



DC-nucleus 

This is a collection of data comm routines invoked from 
the data comm communicate slices. This slice is assembled 
at an absolute address. Part of the DC-nucleus is the 

PMLC (programmable multi line control), which is a con- 
troller for the OCP. The job of the PMLC is to service all 
interrupts from any DCP. The four types of interrupts 
are: 

1. 7PM or 8PM parity error. 

2. SPM parity error. 

3. Result queue needs service. 
h. DC system needs memory space. 



DC-task- 
This: 

1. 

2. 

3- 



EOJ-sl ice 

Detachs the current task from all subnet queues. 
Detachs the current task from all station queues. 
Sends a detach message to the MCS indicating the 
task being detached. 



DC-loader 

First phase of loading a data comm subsystem. 

Provides: 

1. Get space for the DC queue handler TCB. 

2. Get space for the DC space handler TCB. 

3. Opening of the NDLSYS file. 

k. Size calculation of DC-space-slice and allocation of 
memory for it. 



interfaces with: 
not ready 



Help-task-sl ice 

This slice is an independent runner that 

1. All I/O controllers because of a 
condition while in use. 

2. OL-slice. 

3. MH-slice. 

k. Virtual memory. •* 
5. Reconstruct. 
Provides: 

1. Printing of Not Ready message for all devices 

when required. 
2. Configuration table maintenance. 

1*1/65 Working-set-bailiff 

The working set bailiff is composed of two modules. One is 
resident in the MCP-nucleus and the other is a micro slice 
and an independent runner. 
The functions of the independent runner module are: 

1. Evict task run structure from memory to backing 
store for one of the following reasons: 

1) Operator stops the task. 

2) Virtual memory routine senses there is 
insufficient memory available to 
fullfill a request for memory allocation. 
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3) Thrashing is detected. 
U) A program is loaded. 
2. Restore task's restructure from backing store to 
memory for the following reasons: 

1) Operator "GOs" a stopped task. 

2) SCL has information for the task (AD, AX) . 

3) The task can be run and the current task has 
released required system resources. 

One task is evicted at a time until memory requirements 
are satisfied. The priority with which tasks are evicted 
is to evict the lowest priority task that is: 

1. Stopped. 

2. Long-waited. 

3. Runnable. 

One task is restored at a time until one does not fit. The 
priority with which tasks are restored is: 

1. Task receiving SCL information. 

2. Highest priority runnable task. 

1*2/66 Clear-start 
Provides: 

1. Access to system disk sector 31 which contains the 
restart information. 

2. Display of the Clear/Start message. 

3. Loading of WS-1 to memory and then passing control to 

it. 
i». Called by power-off slice to display the PO 

message and re-enter warmstart if the system disk 
was powered off. 

43/67 Configurator 

Processes requests by some utilities for the names of all 

disks on-1 ine. 

W68 OS-tracer 

Invoked by a "GT" SCL command which gives a trace of all 
communicates on a line printer. The trace listing has 10 
columns of D-words. The first column is the current task's 
mix number, the second column is the absolute address of 
the current task's communicate parameter area, and the last 
eight columns contain the communicate. 

1*5/69 DC-EOJ-slice 
This: 

1. Puts PHLC in load/clear mode. 

2. Zeroes PMLC controller address in PHT. 

3. Zeroes DC registers. 

k. Removes DC-queue handler's TCB from memory. 

5. Removes DC-space handler's TCB from memory. 

6. Removes DC-space from memory. 
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7. Removes DC-nucleus from memory. 

8. Removes all DC micro slices from memory. 



Ii6/7tf Reconstruct 

Called by help task when an unacceptable integrity 
flag is encountered. It: 

1. Locates pointers to file list, DFH, available 
table. 

2. Steps through DFH: 

1) If codefile found, resets user count and 
deallocates second area if applicable. 

2) If data file found, resets user count. This 
includes VH and DM files except for DMFILOO. 

3) If MCP file found, resets user count if not 
systems disk. 

h) If reserved entry found, deallocates all areas 
indicated. 

3. Rewrites label to indicate good integrity. 

47/71 RY-slice 

Processed RY and SV SCL commands. 

48/72 XD-slice 

Processed XD SCL commands to remove bad sectors from 
disk. 

^9/73 DC-SH-slice 

This slice gets space from the data comm reserve 
buffer pool and links this space to the 
available buffer pool. 

Uk/lk DC-EH-slice 

This slice handles errors reported by the PMLC 
controller and prints them on the SPO. 
Example: SPM PARITY ERROR. 

4B/75 DC-LDR-2 
This: 

.1. Loads NDLSYS file. 

2. Calls DC-pre31-1oad if necessary. 



4C/75 DC-LDR-3 
This: 



1. Half-closes NDLSYS file. 

2. Updates configuration table. 



4D/76 DC-LDR-4 
This: 



1. Opens NDLDCP file. 

2. Loads NDLDCP file. 

3. Half closes NDLDCP file. 
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l»E/77 AD-disk 

Process request to assign a peripheral to a program 
by an operator in the following cases: 

1. Unlabeled input file. 

2. Special forms. 

3 . No file cond i t i on . 
k. Dupl icate file. 

5. Printer unavailable. 

6. No user disk. 



i»F/79 Indexed-slice 

Processes communicates for indexed files. 



50/80 PE stable 

This slice has read-write tables necessary 
for tape DMAC. They are loaded into tape DMAC 
DDP at warmstart time. The tables are: 

1 . Binary to binary. 

2. EBCDIC to ASCII. 

3. ASCI I to EBCDIC. 



51/81 DC-no-DCOH-SLC 

This slice is called as a result of a task 
data comm communicate being received by the 
MCP when the data comm subsystem is not present. 
If this condition exists, a 91 is placed in 
the CD status key and control is passed 
back to the task. 



52/82 Disk-open-2 
Provides: 

1. Location of FPB and configuration table. 

2. Start of construction of FIB. 

3. Search of disk directory for the file name in the 
case of an old file or search of the available 
table for an available disk area in the case of a 
new file. 



53/83 Disk-open-3 
This: 

1. Builds disk file header. 

2. Calculates number of area* and their sizes. 

3. Completes construction of the FIB. 

Sk/Sk Disk-close-2 

Provides: 

1. Updated DFH. 

2. Deallocation of disk space. 
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55/85 



56/86 



57/87 



58/88 

59/89 

5A/90 

5B/91 

5C/92 
5D/93 
5E/9* 



5F/95 
60/96 



Tape-open-2 
Thi s: 

1. Loads tape controller in memory 

2. Searchs tape (s) for file. 

3. Starts construction of FIB. 

Tape-open-3 
Provides: 

1. Completion of FIB construction. 

2. Processing of label handling. 

Tape-close-2 
This: 

1. Rewinds tape. 

2. Purges label. 

.,. ••arks tape saved if closed with lock. 
It. Oesolves FIB. 

Tape-close-3 

This slice is called by EOJ or tape-close-1 

to close a half closed file. 

EOJ-slice-2 

This slice deallocates the virtual memory file 

or changes i t to a dump file if the task was DP'd. 

EOJ-slice-3 

This slice dissolves the TCB and PCB, if the user 

count is zero, and closes the codefile. 

Deal loc-sl ice 

This S I i ce rpturne iinnearl A\ -\. >_-_- .._ «.i-_ ••_• . 

. - -.. — . .._ „,,„.,».*. „ , alv apawc iu me aval laoie 

table. 

OS-susp-sl ice 

Processes task suspensions by the operating system. 

Stream-sl ice 

Processes stream access communicates. 

Index-open-l 

This slice is the first phase of indexed file open 

communicate processing. 

This: 

1. Checks FPB syntax. 

2. Reads in KFPB. 

3. Fills-in fields in extended FPB. 

lndex-open-2 

This slice builds the DFH for a new key-file. 

lndex-open-3 

This slice builds the FIB. 
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61/97 I ndex-open-'t 

This slice reconstructs the rough table if an old 
file is being opened. 

62/98 lndex-close-1 

This slice is called from disk-close-1 if the file 
to be closed is a indexed file and one the following 
conditions exists: 

1. The file is being locked. 

1) New file - build KFPB. 

2) Old file - merge if opened I/O or extend 
and merge bit is set. 

2. The close adverb is remove. 

1) New file - build KFPB. 

2) Old file - merge if opened I/O or extend 
and merge bit is set. 

3) Old and new file - the old file should 
already be purged, the new file is now 
locked. 

3. The close adverb is release and the file is old. 

1) No name is inserted in KFPB. 

2) Merge if opened I/O or extend and merge 
bit is set. 

it. The file is being half-closed. 

1) New file - build KFPB. 

2) Old file - establish link to data file. 

3) No merge is allowed. 

Close with purge or release and file is new does 
not invoke this slice. 

63/99 SPO-console 

Controller for 120 cps console/SPO. 

61*/ 100 Inter p-subs 

This slice is the interface for the interpreters to relinquish 
control of the machine to the operating system and 
through which control is returned back to them. It is loaded 
to. micro memory 1 (logical page) at warmstart time and is 
not overlayable. The slice descriptor shows an absolute 
memory address in MM1 but the slice length is invalid. 

65/101 Console-slice 

Controller for 120 cps console files. 

66/ 1 02 I ndex-open-5 

This slice completes the open if an old file is 
being accessed output sequential. 

67/103 Sort-slice-1 

This slice is called by S0RTINTRINS, an MPLII program, with 
a micro library call. Tags are built from user-specified 
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kevs and are wr i tfpn to a C7&ft~huta uint-L ai-os Uk pn t-h!e 
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work area is full, these tags are sorted into ascending or 
descending order and then written to a work file named 
BS.FILE. These blocks of sorted data are called strings. 
This routine loops until the input file is at EOF and then 
returns back to SORTINTRINS. 

68/101* Sort-sl ice-2 

This slice is called by SORTINTRINS, an MPLii program, with 
a micro library call. The strings in work file BS.FILE, 
created by sort slice 1, are continually merged by way 
of a four-way table merge until there is only one string 
left. From this tag file a full record data file, tag file, 
or key file is generated depending on the type of sort 
requested. If a merge of two or more files is requested, 
the entire merge is done by SORTINTRINS. 

69/105 Sort-sl ice-3 

This slice is for future use. No code exists for it in the 
MCP file. 

6A/106 DC-ch-34 

Processes data comm communicates with a verb value of 3*t. 
This slice is entered from the master communicate 
handler. The adverb values are: 

Communicate Adverb 



DCP. reload 


00 


DCP . program . names 


01 


DCP . program . count 


02 


DCP. description 


03 


DCP. program. terminals 


ok 



6B/107 DC-CH-redef2 

This slice checks for consistency of parameters 
after a redefine. 

6C/109 DDE-SPO 

Controller for the DDE SP0. 

6D/109 DDE-con 

Controller for DDE console files. 

6E/110 Log-task-slice 

This si ice maintains the log files for both SP0 
and maintenance entries. 

6F/111 SSC-slice 

Processed requests by privileged users for a system 
status (MPL construct) . 
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70/112 Disk-pack-ctlr 

Controller for disk pack. 

71/113 Large-scrn-SPO 

Controller for the TD 830 SPO. 

72/lH FD-slice 

Processes SCL command to define the format of output 
to a serial printer. 

73/115 Int-mul-div 

This slice processes decimal arithmetic for the 
interpreters. 

7U/116 DC-pre31-load 

This slice loads a NDLSYS file that was compiled prior 
to 3.1 NDL compiler release. 
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SECTION 12 
B800 CMSMCP FILE 



The B 800 CMSMCP file is a single area file which has all the microcode 

necessary to operate the system, with the exception of the NDL data comm 

processor micro code which is loaded into the data comm processor if an MCS is 

executed. The NDL data comm micro code is handled as a separate system file. 

internal structure of the B 800 CMSMCP fiie is broken down into three portions. 
The first portion is a one-sector available table which is used in the plant to 
mark areas of the MCP file that they have removed for testing and analysis 
purposes. This area should never contain any entries on a field level MCP file. 
The next portion of the file is a 2l»-sector slice descriptor table describing 
the various MCP slices located in the third portion of the file. Each sector of 
this slice descriptor table contains 11 entries of 16 bytes each. The format of 
the B 800 MCP slice descriptor is given in table 12-1. This table is used by the 
warmstart routine to build the slice descriptor table (SDT) in memory and by 
patch in altering the disk slices. Note that there are two slice descriptor 
tables; one in the MCP file and one in memory. It is important not to confuse 
them. 

Table 12-1. Field Contents 



Byte I 
Within 


Dffset 
Entry 


- 


3 
k 


6 - 

8 - 

10 - 


5 
7 
9 

11 


12 - 
H - 


13 • 
15 


as=ASCI 1 





OS si ice- ID 

micro si ice number 

slice descriptor offset in sector 

sector no. of table for this slice entry 

offset in MCP file of the start of the slice 

length of the slice in D-words 

location to load in memory 

date slice assembled (mm/dd) 



Data 


Notes 


Code 




as 


(1) 


bi 


(2) 


bi 


(3) 


bi 


W 


bi 


(5) 


bi 




bi 


(6) 


de 


(7) 



bi=BINARY 



de=DECIMAL 



related notes: 

1. The OS slice ID is the first four characters of the slice name given by the 
assembler programmers when the slice is declared to the assembler. For 
example, the first slice (slice 0) ID is OS-S. This is the first four 
characters of the slice name OS-SUBS, the name given to the system 
registers and basic subroutines slice. Similarly, the second slice (slice 
1) is identified as WS-I which is the first four characters of the slice 
name WS-I I used as a section of the warmstart function. 
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2. The micro slice number is the relative slice number of this descriptor from 
the start of the slice descriptor table in the MCP file (starting at zero). 

3. The slice descriptor offset in sector is the base zero relative location of 
this slice descriptor in this sector. 

i». This is the sector number within the MCP file slice descriptor table in 
which this slice entry occurs. 

5. Offset within the MCP file of the start of the data contained in this micro 
slice, in sectors, starting at base zero. 

6. With the one exception of OS-SUBS, this field, if not zero, indicates the 
absolute memory address in D-words at which this micro slice is loaded. If 
zero, the slice can be loaded in the slice area of memory (between base of 
the base of virtual memory and slice extent) at loader discretion. This 
field is zero for OS-SUBS because this slice starts at absolute memory 
address zero. 

7. Date slice assembled indicates the month and the day of the month when this 
slice was last assembled for this version of the MCP. 



The third portion of the MCP file consists of the disk copies of all micro 
slices used in the system. It includes the interpreter for BIL/MPLII, COBOL, 
pocket select language (PSL) , and data comm interfacing to the NDL system, as 
all the MCP slices needed to manage the system. The slices are formatted in 
three ways: 

packed - 90 micros per sector 
unpacked - <*5 micros per sector 
data slices - tables or ASCII data 

A packed micro slice is one which is either part of the operating system nucleus 
(OS-SUBS, OS-NUCLEUS, DC-NUCLEUS) or is a free-standing piece of micro code 
which does not run under the operating system (warmstart, clear/start, and patch 

— 1 : — -, * * «•*.■• «tu S «n.1*v\ TUapa *» 1 * 0* «*»• » I ■"»*•> a tkpu a v * #» ♦■ *»e eAi-tar-a + A An+i + iAe r\r ae 

d 1 iv,£S t 1 ui CAaiiipie/ • incac 1 1 vcs t smivc liiw; vai *». *»-» ■vwkrwi ukw w« 1 b • h ■ *»*# w* *- w 

part of the fixed nucleus, do not need an internal addresses "fixed up" when 
they are loaded into the system and are therefore packed 90 micros to a sector. 

Unpacked slices, however, are those which are loaded into main memory at 
different addresses -depending on the system operating state at the time the 
slice is needed. Since these slices must "call" and "jump" both within 
themselves and to the routines within the fixed address area of the operating 
system nucleus, each executable micro is followed by a flag word which indicates 
to the loader (the disk DMAC control) whether the preceding micro instruction 
needs its "address part" fixed to point to a~ address relative to the base of 
where this slice is located in memory or whether it should be left undisturbed. 
It is left undisturbed when it is either a non-address type micro or it refers 
to an absolute address within the OS nucleus. A micro requiring "fix up" is 
suffixed by a D-word containing ©80006. Otherwise, it is followed by a word 
containing §0000@. 



12-2 



A data slice Is one that contains only ASCI! data in the form of a look-up table 
or a table of operating system messages. Since these tables are accessed only 
in a look-up manner and do not contain direct executable micro code, they are 
packed with 180 bytes of data or table per sector. 
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APPENDIX A 



BMAR 


memory address register 


BVM 


beginning of virtual memory 


CPA 


communicate parameter area 


CPS 


characters per second 


D-word 


two bytes 


DC 


data communications 


DDP 


device dependent port 


DST 


data segment table 



tvwi 



ena ot virtual memory 



FC 


fetch communicate 


FIB 


file information block 


FPB 


file parameter block 


I/O 


input/output 


ISCT 


interrupt scan control table 


ISN 


interpreter segment number 


MA 


memory address 


MAD 


micro address descriptor 


MAT 


mix attribute table 


MB 


megabyte 


MC 


media controller 


MCH 


master communicate handler 




uigjici viviiuvi piwijiciMi 


MM 


memory management 


MPCR 


micro program count register 


OS 


operating system 



PCA program current address 

PCB program control block 

PHT peripheral handler table 

PSN program segment number 



SDT 



slice descriptor table 



TCB 


task control block 


TDT 


task detail table 


TID 


task ID 


TOS 


top of stack 


TPI 


tracks per inch 


VM 


virtual memory 
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APPENDIX B 
MCP LOGIC ERRORS WORKSHEET 

This should be used as a checkoff sheet when documenting an FTR. 



BMAR e0083t * . 
MPCR §008lf§ » _ 
ERROR §00856 - 



CURRENT SLICE gOOOCg - _ 
CURRENT TASK TiD @O0GA@ 
HARDWARE CONFIGURATION: 



Review: 

SPO log 

mix worksheet 

slice memory worksheet 

peripheral I/O descriptor worksheet 

MCP. trai 1 
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MIX WORKSHEET 

PART 1 

MAT ANALYSIS 

OS register 6000E6 - 

extract the MAT. 

C FFFF 

B FFFF 

A FFFF 



ma ■ manor/ address 



Proceed to this memory address and 



TDT ANALYSIS 

OS register 600176 - 

Add 63C6 giving 

add 603® giving 

Proceed to this memory address. 

Contents ■ 

add 6016 giving 



Proceed to this memory address. 

Contents ■ 

add 60^8 giving 

add 6036 giving 



Proceed to this memory address. 

Contents ■ 

Proceed to this ma and mark off 
dump D-words in the table. 

1 5 Fa S C I I ) 8 



FFFF 



locates the SDT-base ma 

locates the SCL-loader SDT entry 

locates the TCB ma 

locates the start of the TCB 
locates the DST in the SCL TCB 

ma of data segment of SCL-LDR 
ma of data segment 1 of SCL-LDR 
locates the start of TDT 

locates the start of TDT 
sets of 23 D-words on the hex 



(ASCI I ) 



lit 
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MIX WORKSHEET 

PART 2 

Summarize the mix contents in the tables below. 

Independent runners: 

TASK # PRIORITY TASK ID STATUS 

f - C - data comm - 

E - C - working set bailiff - 

D - C - help / CTM - 

C - C - SCL loader - 

B - C - data comm space handle - 

A - C - log - 

9 - B - super utility - 



Identify the status for each of the independent runners above. 



User programs: 
TASK # PRIORITY 
8 - 


TASK 


!D 


7 - 


_ 






6 - 


_ 






5 - 


_ 






!♦ - 


_ 






3 - 


_ 






2 - 


_ 






1 - 


_ 






- 


- 







CTATlie 

*J ■ ft I WW 



Identify the priority, task name, and status for each task 
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CURRENT TASK WORKSHEET 

OS register 6000A6 - task number 

add 601® giving mix number 

program name from mix worksheet 

OS register 600B6§ « line-count in hex 

OS register §00AD@ - current s-opcode 

OS register 6000B6 - current TCB ma 

Proceed to this location and extract 7 D-words 



1 2 


3 


k 


5 


b 7 


PSN/ISN DST 


DST 






MCH-TOS MCH 


BASE 


LIMIT 






RECOVER ACTIVE 
VERB 



(TCB) 



To find the CPA, add MCH active verb (0-word 7) 
to the TCB base (found at 6000B6) 
giving the CPA address 
The contents of the D-word at this address is 



This is the communicate verb (refer to MCP manual section 5) 
To extract the COBOL/RPG perform stack from a hex dump, 

Add MCH-TOS recover (D-word 6 of TCB) 

to the TCB base (found in part 1 at 6000B6) 

giving 



subtract 6016 giving 

Go to this resulting address in the dump and mark off one 
D-word. it represents the boundary between the interpreter's 
part of the stack and the MCP's part. 

Proceed to contents of D-word 3 and mark off sets of k D-words 

LINE- BYTE SEGMENT "K" LINE- BYTE SEGMENT "K" 
COUNT OFFSET NUMBER COUNT OFFSET NUMBER 
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SLICE MEMORY MAPPING WORKSHEET 



Beginning address 
of thi s s i ice is ( 



) (if starting use register @000F§) 



Contents of this 
location is 

Subtract address 
of SDT-base ( 


(SDT entry) 
) 


go to SDT entry 
and extract 5 D- 


-words 




600176 

giving 


1 2 3 

add D-word 3 
to D-word It 
giving 

ess cf next si i 




k 


5 


Divide by §056 


slice 
number 




g i v i ng 










< beginning addr 


ct 


V 

V 





Beginning address 
of this si ice is ( 

Contents of this 
location is 

Subtract address 
of SDT-base ( 
§00176 

giving 

Divide by 6056 
giving 



v 
v 



(SDT entry) go to SDT entry 

and extract 5 D-words 



) 





1 2 3 


k 


5 




add D-word 3 






si ice 


to D-word k 






number 


giving 







Beginning address 
of this si ice is ( 

Contents of this 
location is 

Subtract address 
of SDT-base ( 
600176 

giving 

Divide by 605@ 
giving 



< beginning address of next slice< 

v 

v 



) 



(SDT entry) go to SDT entry 

and extract 5 D-words 



) 



si ice 



number 



1 2 

add D-word 
to D-word 


3 

3 

U 


1* 


5 


givi ng 








V 

V 





< beginning address of next slice< 
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PERIPHERAL I/O DESCRIPTOR WORKSHEET 



OS register 600A36 - ma of ISCT. 

Proceed to this ma and extract 12 D-words. 



1 2 3 m 5 6 ports 



7 8 9 10 11 12 ports 

Selected device 

Select the ma corresponding to the port on which this device is 
located. 

Add 8026 giving ma of the current I/O 

contents - ma of I/O descriptor 

Proceed to this ma and extract k D-words. 

(queued I/O descriptor) 



12 3* 

(queued I/O descriptor) 

1 2 3 *» 

(queued I/O descriptor) 



1 2 3 •* 

D-word 1 contains the interlock and op code. 

D-word 2 contains the next I/O descriptor ma or an ma pointing 

back to the PHT. 

Selected device 



Select the ma corresponding to the port on which this device is 
located. 

Add §026 giving ma of the current 1/0 

contents ■ ma of 1/0 descriptor 

Proceed to this ma and extract h D-words. 

(queued 1/0 descriptor) 



1 2 3 * 

(queued 1/0 descriptor) 

1 2 3 * 

(queued 1/0 descriptor) 



D-word 1 contains the interlock and op code. 

D-word 2 contains the next 1/0 descriptor ma or an ma pointing 

back to the PHT. 
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Documentation Evaluation Form 



Title: B 800 Systems MCP Memory Dump Analysis Form No: 1118452 



User's Guide ; Date; January. 1981 
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